home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / tbbs111.zip / LISTCVT.DOC < prev    next >
Text File  |  1997-08-19  |  6KB  |  139 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                List Converter 11.0
  8.                      Copyright (c) 1997 By Freejack's Software
  9.                         Copyright (c) 1995-1996 By Trisoft
  10.  
  11.      List Converter is used to convert files lists for BBS systems other
  12.      than TriBBS to the TriBBS 10.0 file list format.  Because List
  13.      Converter uses a collection of templates to determine the foreign file
  14.      list format, it can convert virtually any file list.  You should note
  15.      that List Converter will only work for registered TriBBS 10.0 Pro
  16.      sysops.
  17.  
  18.  
  19.      SETTING UP LIST CONVERTER
  20.      -------------------------
  21.  
  22.      Because List Converter will only work for registered TriBBS 10.0 Pro
  23.      sysops, it must be run for a node's main directory.  The best spot to
  24.      put it is in node 1's main directory.  Let's say your node's main
  25.      directory resides in the directory C:\TRIBBS, you would need to copy
  26.      the files LISTCVT.EXE (the List Converter executable file) and
  27.      TEMPLATE.TXT (the List Converter template file) into the directory
  28.      with commands similar to the following:
  29.  
  30.      COPY LISTCVT.EXE C:\TRIBBS
  31.      COPY TEMPLATE.TXT C:\TRIBBS
  32.  
  33.  
  34.      RUNNING LIST CONVERTER
  35.      ----------------------
  36.  
  37.      List Converter is run by simply entering LISTCVT at the DOS prompt. 
  38.      You will notice that near the top of the screen there are two black
  39.      lines.  The top black line is the sample file list display line.  The
  40.      bottom black line is the template display line. The template display
  41.      line will contain the first template in List Converters template
  42.      file.  Because most CDs come with PCBoard file lists on them, the
  43.      first template displayed is the PCBoard file list template.  List
  44.      Converter is used with the the following keys:
  45.  
  46.      <Alt><L>       This key combination will load a sample file list and
  47.                     display the file list's first line in List Converter's
  48.                     file list display line.
  49.  
  50.      <Down Arrow>   Displays the next line in the sample file list.
  51.  
  52.      <Up Arrow>     Displays the previous line in the sample file list.
  53.  
  54.      <Left Arrow>   Moves the template line's cursor to the next character
  55.                     position.
  56.  
  57.      <Right Arrow>  Moves the template line's cursor to the previous
  58.                     character position.
  59.  
  60.      <Pg Dn>        Displays the next template.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.      <Pg Up>        Displays the previous template.
  67.  
  68.      <Alt><S>       This key combination saves the revised templates. List
  69.                     Converter will prompt you to name the "User Defined"
  70.                     template.  If you do not want to save the "User
  71.                     Defined" template, just leave the name blank and List.
  72.                     Converter won't bother to save it.
  73.  
  74.      <F>            Sets the starting position for the file's name in the
  75.                     file list template.
  76.  
  77.      <L>            Sets the starting and ending positions for the file's
  78.                     length in the file list template.  Because the file
  79.                     length can be a variable length field, pressing <L> the
  80.                     first time will only mark the starting position for the
  81.                     file length.  Once you have marked the file length's
  82.                     starting position, move the template line's cursor to
  83.                     the right and press <L> again to define the file
  84.                     length's ending position.
  85.  
  86.      <D>            Sets the starting position for the file's date in the
  87.                     file list template.  You should note that List
  88.                     Converter can work with dates using either the MM-DD-YY
  89.                     or YYMMDD formats.  MM-DD-YY is the default format. 
  90.                     You can toggle this to the YYMMDD format, by leaving
  91.                     the template line's cursor in the date's first position
  92.                     and pressing <D> again.
  93.  
  94.      <X>            Sets the starting position for the file's description. 
  95.                     List Converter assumes that the description's ending
  96.                     position is the end of the line.
  97.  
  98.      <Alt><X>       This key combination starts the conversion process.
  99.                     List Converter will ask you to enter the file name for
  100.                     the file list(s) to be converted.  You can use DOS wild
  101.                     card characters to specify multiple files in a single
  102.                     directory.  List Converter will then ask you to enter
  103.                     the name of the directory that you want the converted
  104.                     file list(s) to be placed in. Please note that List
  105.                     Converter will use the original file list's name for
  106.                     the converted file list; therefore, you should not
  107.                     specify the same directory where the original file
  108.                     list(s) are located.
  109.  
  110.  
  111.      NOTES ABOUT LIST CONVERTER
  112.      --------------------------
  113.  
  114.      Although List Converter does an excellent job of converting file
  115.      lists, it's not perfect.  Some BBS file list formats permit headers in
  116.      the file lists.  If the file lists you want to convert have headers,
  117.      they will have to be removed manually with a text editor before
  118.      running List Converter.  List Converter will not word wrap a
  119.      description as long as the description's first line is 45 characters
  120.  
  121.  
  122.  
  123.  
  124.  
  125.      or less.  List Converter will assume that a 02H byte in the
  126.      description is a line break.
  127.  
  128.  
  129.      USER-DEFINED TEMPLATES
  130.      ----------------------
  131.  
  132.      Because List Converter allows you to define your own file list
  133.      templates, it can convert virtually any file list out there.  If you
  134.      do create templates of your own, please upload your TEMPLATE.TXT file
  135.      to TriSoft so that your user-defined templates can be included in
  136.      future releases of the List Converter template file.  Please try to
  137.      name the templates as to the type of BBS software or CD that the
  138.      original file list came from.
  139.